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CHAPTER 1 
S16XAL SYMBOLIC CROSS ASSEMBLER 

1.1 INTRODUCTION 

The Series 1600 Symbolic Cross Assembler (S16XAL) is a program preparation 
aid which supports General Instrument's family of 16-bit microprocessors. It 
translates ASCII coded alphanumeric source programs into several different 
types of binary coded object modules. The S16XAL Symbolic Cross Assembler 
is written in F level Fortran IV and is designed for operation in a 16 -bit data 
word environment making it compatible with all minicomputers as well as larger 
computer systems. 

1.2 FEATURES 

The S16XAL Symbolic Cross Assembler provides the following major features: 

• Symbolic language representation of all instructions 

• Literal representations in four formats; Octal, Decimal, Hexadecimal, 

Character 

• Arithmetic evaluation of operand expressions 

• Assembly directives for 

Controlling memory allocation 
Defining character strings 
Specifying input /output options 
Establishing conditional assemblies 
Declaring global and external gymbols 

• Assembly in three forms 

Absolute 
Relocatable 
Relocatable/ Linking 

• Program listings 

• Error detection 

1.3 OPERATION 

The S16XAL Symbolic Cross Assembler converts symbolic source programs into 
machine code format in a two pass process. During the first pass through the 
source file>, all user specified symbols are placed in a symbol table containing 
the symbol, its value, and several other attributes. During the second pass 
throu^ the source file, symbolic instruction mnemonics are translated, symbol 
references resolved, errors diagnosed, a machine code file generated, and an 
optional program listing produced. 

The machine code file produced by the S16XAL Cross Assembler can be of several 
forms. If the source program specified an absolute assembly, the binary file will 
be an absolute load module. An absolute load module can be directly loaded and 
executed by the Series 1600 Simulator (S16SIM) or punched on paper tape for sub- 



sequent loading in a microprocessor system by the resident loader (S16LDR). 
If the source program contains global symbol definitions and/or external symbol 
definitions and /or external symbol references, the binary file will be a relo- 
catable object module. Relocatable object modules must be linked together by 
the Series 1600 Object Module Linker (S16LNK) to form one relocatable load 
module for input to the Series 1600 Simulator (S16SIM). Alternatively, relo- 
catable object modules or load modules may be punched on paper tape for sub- 
sequent loading in a microprocessor system by the resident relocatable/linking 
loader (S16LDR). If the source program does not contain global or external sym- 
bol references, the binary file will be a relocatable load module which can be di- 
rectly loaded and executed by the Series 1600 Simulator (S16SIM) or punched on 
paper tape for loading on a microprocessor system by the resident loader 
(S16LDR). These options are shown diagramatically in Fig. 1.3.1. 

1.4 SOURCE PROGRAM FORMAT 

A S16XAL source program is composed of a sequence of statements with each 
statement contained on a single line. A statement is terminated by a carriage 
return character or is punched on one computer card. A statement may contain 
up to four fields which are identified by their order of appearance from left to 
right. The general format of a S16XAL statement is: Label, Operator, Operand, 
Comment. The label and comment are optional, while the operator is always re- 
quired. The presence and nature of the operand depends upon individual operators. 
It is recommended that statements be limited to approximately 50 characters so 
that assembled programs can be printed on teletype or CRT terminals. 

1.4.1 Label 

A label is a user defined character string, used to symbolically refer- 
ence a specific location within a program. If a statement contains a label, 
the label must begin in the first position of the statement. Labels may 
contain up to six characters, the first of which must be a letter (A-Z), a 
currency symbol ($), a question mark (?), or an ampersand (&). The re- 
maining five optional characters may be any valid character (EBCIDIC or 
ASCII) except a blank space, since this character is the label terminator. 
Labels containing more than six characters cause a diagnostic to be issued 
and are truncated after the sixth character. Labels must be unique in the 
first SIX characters, i. e. , a specific character string cannot be used in 
the label field of a statement more than once in a program. Multiple use 
of a label causes a diagnostic to be issued and the subsequent definitions 
of the label to be ignored. 

1.4.2 Operator 

An operator follows the label field in a statement. A statement operator 
contains up to four characters and may be an instruction mnemonic or an 
assembly directive. Instruction mnemonics are symbolic character 
strings which represent the various Series 1600 instructions. Assembly 
directives are also symbolic character strings but are used to represent 
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certain functions or actions performed by the assembler during the 
assembly process. K a statement does not contain a label, the operator 
must be preceded by at least one blank space. If the operator is the 
last field in a statement, it is followed by a carriage return, otherwise 
it is followed by a blank space. 



1.4.3 Operand 



An operand follows the statement operator separated by at least one 
blank space. The operand represents an item or items to be operated 
upon by the statement operator. Operands may be symbols, literals or 
expressions. When multiple operands are used, they are separated by 
commas. If an operand is the last field in a statement it is followed by 
a carriage return, otherwise it is followed by the comment field. 



1.4.4 Comment 



The comment field is optional in all statements and must be preceded by 
a semicolon (;). The contents of the comment field are printed on the 
program listing but have no effect on the assembled program. Entire 
lines may serve as comments if the first non blank character is a semi- 
colon. Blank lines are printed on the program listing but otherwise ig- 
nored so that statements may be separated in order to enhance program 
readability. The liberal use of commentary is strongly recommended 
so that the function and operation of programs is evident from the program 
listing. 

1.5 SYMBOLS 

A symbol is a character string which appears in an operand and represents the 
value assigned to the symbol. A symbol is given a value by direct assignment 
via an assembly directive or by appearing in the label field of a statement. Labels 
are assigned the value of the assembly location counter for the instruction on which 
they appear. The assembler recognizes the exclamation (!) sign as a special s5mibol for 
the current value of the program counter. 

1.6 LITERALS 

Literals are character strings which serve as sources of data, i.e., cannot be 
changed and are interpreted by the assembler as constants. The assembler accepts 
literals expressed as octal, decimal, hexadecimal and character. Num^eric literals 
may be preceded by a plus or minus to signify sign. Plus is assumed unless a minus 
is present. 



1.6.1 Octal (Default Radix) 

scx)oooo - s = optional + or -, + assumed 



1.6.2 



1.6.3 



1.6.4 



Decimal 



s^idddd 



Hexadecimal 



sX'hhhh' 



ASCII Character 



'cc" or ^c' 



= 0-7 

oooooo = to 177777 



s = optional + or -, + assumed 

d = -9 

ddddd = - 32768 to 32767 



s = optional + or -, + assumed 
h = 0-9, A - F 
hhhh = to FFFF 



"or' = delimiter 

c = any ASCII character 

One or two characters may be packed into each 
16-bit word. If one character is specified ("c'' or *c*) 
it is placed in the low order byte of the word with 
zeros in the high order byte. If two characters are 
specified C'ab" or *ab') the first (a) is placed in the 
low order byte and the second (b) is placed in the high 
order byte. 



1.7 EXPRESSIONS 



Arithmetic operators (+and -) may be used to form operand expressions. An 
element of an expression may be: a user defined symbol, the current assembly 
location counter symbol (! ), or a literal. Expressions may contain up to six 
elements separated by either + or - operators. The total expression may be 
terminated by a comma, a carriage return or a semicolon* Expressions are 
always evaluated from left to right with no parenthetical groupings allowed. 

1.8 ASSEMBLY DIRECTIVES 

Assembly directives are used to control the assembly process and in some cases 
cause data to be generated. In the following assembly directive descriptions op- 
tional elements are enclosed in [ ] . Comments may be used with all assembly 
directives. 



LABEL OP 



OPRND 



ACTION 



1.8.1 



1.8.2 



PAGE 



HEAD ^ccc.c^ 



1.8.3 



REL [name] 



1.8.4 



ABS 



1.8.5 



ENTR 



Advance program listing to the top 
of the next page. Sixty lines are 
normally printed on each page. 

Use the character string specified as 
the operand as a page heading for the 
next page. The first character in the 
string is used as the string terminator. 

Generate a relocatable assembly and 
use the six character name as the ob- 
ject module identifier. If no name is 
specified, an unnamed relocatable ob- 
ject module is generated. The module 
name is used by the Series 1600 Object 
Module Linker (S16LNK) to identify ob- 
ject modules on its load module map. 
The REL directive must be encountered 
by the S16XAL assembler before any 
data generating operators are processed. 
If this is not the case, an informative di- 
agnostic is issued and an unnamed relo- 
catable object module generated. If no 
REL or ABS directive is specified, an 
unnamed relocatable object module is 
generated; i. e. , REL is the default 
assembly mode. 

Generate an absolute assembly; the binary 
file generated by the S16XAL assembler 
will be an absolute load module. It can- 
not be relocated or linked when loaded. 
The ABS directive must be encountered 
by the S16XAL assembler before any data 
generating operators are processed. If 
this is not the case, an informative diagnos- 
tic is issued and an unnamed relocatable 
object module is generated. 

Establish the program entry point; i. e. , 
the point at which execution is to begin. 
The operand may be either a symbol or 
a literal. 



LABEL 



1.8.6 



OP 
GLOB 



OPRND 



b[ , by • • • 9 b J 



1.8.7 



EXT 



b^, b, • • • y b J 



1.8.8 



1.8.9 SYMBOL 



ORG 



EQU 



expr 



V 



1.8.10 [LABEL] RES 



expr 



1.8.11 [LABEL] 



ZERO 



expr 



ACTION 

Declare the symbol (s) as global. Global 
Global symbols must be defined as labels 
in the current program unit but can be 
referenced from other program units. 

Declare the symbol (s) as external. Ex- 
ternal symbols reference global sjnnbols 
in other program units . Both external 
and global symbol references are re- 
solved by the Series 1600 Object Module 
Linker (S16LNK) and the relocatable/ 
linking loader (S16LDR) resident in the 
microprocessor system. 

Set the assembly location counter to the 
value of expr, default is zero. 

Assign the value of the operand to the sym- 
bol. The operand may be a symbol, a 
literal or the assembly location counter 
symbol (f). If ! is specified it may be 
followed by + or - and a literal. 

Reserve a block of storage whose length 
is specified by expr. The contents of 
individual storage locations is undefined. 
If a label is specified, it is assigned a value 
equal to the address of the first word in 
the block. 

Zero a block of storage whose length is 
specified by expr. If a label is specified, 
it is assigned a value equal to the address 
of the first word in the block. 



1.8.12 



BITS 



expr 



1.8.13 



MEML exprl[, expr 2] 



Specify the number of bits in a memory 
word as the value of expr. The word size 
is used by the assembler to check gener- 
ated data for magnitude exceeding word 
size. The default is 16 bits. 

Specify lower and upper memory address 
limits as the values of exprl and expr 2. 
If only exprl is specified, its value will 
be used as the upper memory address 
limit and the lower limit will be set to 
zero. These limits are used by the as- 
sembler to check the validity of addresses 
assigned to generated code. The defaults 
are and 17777. 



LABEL OP 



1.8.14 [LABEL] WORD 



OPRND ACTION 

expr [, expr , . . . , expr] Generate a data word for each 
operand expression. The contents of 
each word is set equal to the value of the 
respective expr. If a label is specified it 
is assigned a value equal to the address 
of the first word. 



1.8.15 [LABEL] BYTE expr [, expr, 



1.8.16 [LABEL] TEXT 



1.8.17 



1.8.18 



END 



EOT 



. , expr] Generate two data bj^es for each 
operand expression. The operation is the 
same as with but 8 bit data is gen- 

erated for use with double byte addressing 
in 10 bit memory. 



*cc. . . . cc' Generate a word or words of data which 
contain the seven bit ASCII code for each 
character. Two characters are packed 
in each word, low byte to high byte. In- 
complete words contain a blank in the high 
byte. If a label is specified, it is assigned 
a value equal to the address of the first 
word generated. 

End of the program, the assembly is 
terminated on the previous statement 

End of tape indicator, used to separate 
a source program into several paper tapes. 
This directive is ignored by the file 
oriented cross assembler. 



1.8.19 



NLST 



Disable the program listing. The assembly 
proceeds normally but with the listing 
suppressed. This directive is used, for 
example, to avoid printing a length ZERO 
block. 



1.8.20 



LST 



Enable the program listing. This directive 
is used to cause a listing to again be pro- 
duced after a NLST directive. 



1.8.21 



IFEQ 



expr 



Start conditional assembly. The state- 
ments that follow will be assembled if expi 
is equal to zero. If expr is not equal to 
zero, the statements will be listed but not 
assembled. Conditional assemblies are 
useful when a program has statements which 
are to be assembled only under certain 
conditions. For example, statements 
which are to be assembled only during 
debugging of the program. 



LABEL 



OP 



OPERAND 



ACTION 



1.8.22 



IFNE 



expr Start conditional assembly. The follow- 

ing statements will be assembled if 
expr is not equal to zero, the following 
statements will be listed but not assembled. 



1.8.23 



ENDC 



End conditional assembly, i.e. 
normal assembly. 



resume 



1.9 PROGRAM LISTING 

The S16XAL Symbolic Cross Assembler produces a listing of the assembled program 
containing the following fields: line numhex; six octal digits of address; six octal 
digits of contents; the statement label, operator, operand and comments. The oper- 
ator, operand and comments are tabulated to enhance program readability. If the 
assembled word is subject to modification when the program is loaded at an address 
different than that of assembly; i. e. , relocated, the contents are followed by the 
letter ''R". If the assembled word references an external sjmibol, the contents are 
followed by the letter ''X\ 

Each page of listing contains sixty lines and begins with a one or two line heading. 
The first heading line contains the module name, the version of the assembler in 
use, the time and date of the assembly and the page number. If the user has speci- 
fied a heading via the HEAD directive, it follows on the next line. The program 
listing follows, separated from the page heading by a blank line. 

At the end of the program listing, all user defined symbols are summarized followed 
by the number of diagnostics issued. The symbol summary contains each symbol 
in alphabetical order, its octal value, and its attributes. The following table lists 
the codes used for symbol attributes: 

U - symbol is undefined 

A - symbol is absolute 

R - symbol is relocatable 

X - symbol is external 

IN - symbols is an instruction label 

EQ - symbol is defined by an EQU statement 

RS - symbol is a RES or ZERO statement label 

DT - symbol is a WORD BYTE, or TEXT statement label 



G - symbol is global 

E - symbol is entry point 

DD - symbol is doubly defined 

UR - symbol is unreferenced 



1. 10 DIAGNOSTICS 



The S16XAL Symbolic Cross Assembler performs extensive error checking 
during program assembly issuing both error and informative diagnostics. 
Each diagnostic is printed on the program listing on a line immediately pre- 
ceeding the offending statement. Diagnostics and the associated statement are 
always listed even though the program listing is-surpressed or no listing was 
requested by the user. 

The S16XAL assembly error codes are listed in the following table: 

ERROR CODE MEANING 



label illegal or missing 

label is doubly defined 

reference to undefined symbol 

reference to multi defined symbol 

operator is unrecognized 

syntax illegal 

register designator illegal or use of reg illegal 

character is illegal string terminator 

double byte data sequence illegal 

label's value differs in phase 2 

more than one external symbol in expression 

value of operand illegal 

value of literal illegal 

questionable syntax 

word size exceeded 

address out of range or destination questionable 

possible statement truncation 

END directive missing 

questional use of directive 

memory limits exceeded 



The S16XAL Assembler is available for use on several interactive computer 
systems. In order to assemble programs, the user must first estalish communi- 
cations with the computer and log in with a valid account number or user code 
(see appropriate System Operation Manuals), After the log in has been completed, 
the computer operating system responds with a prompt character ($ or * used on 
many systems). The user responds by entering a command which requests the 
operating system to load and begin execution of the S16XAL assembler. The assembler 
first identifies the version in use by displaying S16XAL-VXX, then displays the 
message: SOURCE FILE, ACCNT?. The user must enter an appropriate source 
file name followed by a comma and the account in which the file exists. On 
some systems, if the source file exists in the current account the comma and 
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account may be omitted. Next the assembly listing option is requested by the 
message: LISTING? (Y/N OR F = NAME). If N is entered, no listing except 
for diagnostics will be produced, if Y is entered the program listing will be 
output on the interactive terminal. If F=name is entered the listing will be 
output to the named file. Finally the object file name is requested by the mes- 
sage: OBJECT FILE?. At the end of the assembly if no terminal listing was 
requested the number of diagnostics issued is summarized. This concludes the 
current assembly and another source file is requested for the next assembly. 
If only a carriage return is entered, the assembler returns control to the op- 
erating system. 



CHAPTER 2 
S16LNK OBJECT MODULE LINKER 

2.1 INTRODUCTION 

The Series 1600 Object Module Linker (S16LNKXis a support program to the 
Series 1600 S)niibolic Cross Assembler (S16XAL). It combines or links to- 
gether two or more relocatable object modules produced by the S16XAL 
Assembler to form the single relocatable load module necessary for input to 
the Series 1600 Simulator (S16SIM). The S16LNK Object Module Linker is 
written in F level Fortran IV and is designed for operation in a 16 -bit data 
word environment making it compatible with all minicomputers as well as 
larger computer systems. 

2.2 FEATURES 

The S16LNK Object Module Linker performs the following functions on object 
modules generated by the S16XAL Cross Assembler: 

Resolves global symbol declarations 
Satisfies external symbol references 

Relocates and links multiple object modules into one load module 
Produces a load module memory map 

Generates a load module file for subsequent execution by the 

S16SIM Simulator 



2.3 OPERATION 

The S16LNK Object Module Linker performs the linkage function by making two 
passes through the specified object modules. During the first pass, a table of 
global s5mibols and their assigned addresses is constructed and a load module 
memory map is generated. The map lists the object modules in order of linkage, 
the relocated base address of each objeqt module, all global symbols and their 
associated addresses in each module, s^rid the size of each module. At the end 
of the first pass, a linkage summary is produced which indicates the initial ad- 
dress, the final address, and the entry address of the relocatable load module. 
During the second pass, each object module is again read and the load module 
file is constructed. 

2.4 INTERACTIVE DIALOGUE 

The S16LNK Object Module Linker operates interactively with the user via any 
appropriate terminal. Upon program initiation the current version is use is iden- 
tified and the user is requested to name the resultant linked load module file by 
the message: LOAD MODULE ? 

If a load module file currently exists with the same name, it is deleted and a 



new file of the same name created. Next, the user is requested to select a 
load map option by the message: MAP ? (Y/N or F = NAME) 

If the user enters "N", no map will be produced; if a *'Y'* is entered the map 
will be output on the terminal. If, however, F = NAME is entered the map will 
be output on a file with the specified name. Finally, the user is requested to 
enter the names of the object modules to be linked by the message: OBJECT 
MODULES? 

The user enters each object module file name in response to a prompt ":". 
If an object module exists in an account which is different than the current 
account, the account code is entered on the same line immediately after the file 
name separated by a comma ", ". The end of the object module identification 
sequence is indicated by entering a null line, i. e. , only a carriage return. 
The S16LNK Object Module Linker then performs the required linkage and re- 
sponds with the load map if the user so requested, followed by the linkage sum- 
mary. 

2.5 ERROR DIAGNOSIS 

During the linkage process, S16LNK detects several error conditions and issues 
the following diagnostic messages: 

• FILE DOES NOT EXIST ! 

The last object module file specified does not exist, 
enter another file name. 

• OBJECT MODE : x x x x x x NO LONGER EXISTS ! 

The indicated object module file has been deleted during 
linkage, link aborted. 

• MODULE : X X X X X X NOT REL, CANNOT LINK ! 

The indicated file is not relocatable, i. e. , it was 

declared absolute via the ABS assembly directive, link aborted. 

• ! 1 MULTIPLE ENTRY DEFINITION : x x x x x x IGNORED 

More than one entry point was specified, link continues. 

• CANNOT ACCOMMODATE ANY MORE GLOBALS ! ! 

The global symbol table has overflowed, link aborted. 

• ! ! MULTIPLE GLOBAL DEFINITION : x x x x x x IGNORED 

A global symbol has been defined more than once, link 
continues. 



• UNSATISFIED EXTERNALS 

SSSSSS NNNNNN 

The indicated external symbol references could not be 
resolved because corresponding global symbols are 
not known. NNNNNN is the address of the first word of 
the instruction containing the external reference. The 
symbol is assigned value zero and the link continues. 

• ILLEGAL UNKAGE CODE 

A non valid linkage code was detected, link aborted. 

2.6 LIMITATIONS 

Since S16LNK is not a program loader, the linked relocatable load module size 
is limited only by available file space, not by memory size of the host computer. 



CHAPTER 3 
S16SIM SIMULATOR 

3.1 INTRODUCTION 

The Series 1600 Simulator (S16SIM) is a program debugging aid for the Series 
1600 Microprocessor System. Its input is either a relocatable or absolute 
load module derived from the Series 1600 Symbolic Cross Assembler (S16XAL) 
or from the Series 1600 Object Module linker (S16LNK). The S16SIM Simu- 
lator executes each instruction of a Series 1600 program in a simulated micro- 
processor environment allowing detailed examination of program flow and dyn- 
amic conditions in the simulated system. The S16SIM Simulator is written in 
F level Fortran IV and is designed for operation in a 16 -bit data word environ- 
ment making it compatible with all minicomputers as well as larger computer 
systems. 

3.2 FEATURES 

The S16SIM Simulator provides a comprehensive simulation facility for debugging 
and testing Series 1600 programs before they are executed on an actual victual 
microprocessor. It provides the following major features: 

Simulation of all Series 1600 instructions 

Simulation of full 65 K memory 

Simulation of I/O via data files 

Simulation of external interrupts 

Simulation of external branch conditions 

Simulation of TTY I/O via interactive terminal device 

Execution in run or step mode 

Access to all registers and memory locations 

Trap or breakpoint on register or memory activity 

Trace or monitor registers or memory activity 

Simulate varying memory configurations and speeds 

Display actual program execution time 

Determine actual stack depth used 

3.3 OPERATION 

The user communicates interactively with the S16SIM Simulator using a vocabulary 
of commands which control the simulation environment and program execution. 
The user can inspect change, or monitor microprocessor registers and bus ad- 
dresses; begin and suspend program execution; execute a program one instruction 
at a time; simulate real time input/output operations, external interrupts and ex- 
ternal conditions and determine actual program execution time for various com- 
binations of ROM/RAM/CPU clock rates. 



3.4 INITIAL SIMULATOR CONDITIONS 

After the S16SIM Simulator is initially loaded and before any user program is 
loaded or executed the following conditions exist: 

Register 0-7 are set to zero. 

Status bits S, Z, C and OV are set to zero. 

Interrupts are disabled. 

Privileged instruction mode prevails. 

Double byte data is disabled. 

CPU clock rate is 400 nanoseconds. 

External bus accesses are defined at 700 nanoseconds. 

RAM memory is assigned to bus addresses 0-167767 and 

is initialized at zero. 
TTY simulation is assigned to bus addresses 167775-167777. 
All tables are initialized. 

3.5 SYSTEM LOADING 

The S16SIM Simulator provides simulation of the full 65K address capability 
of the Series 1600 microprocessor by virtual memory techniques. The user 
may relocate and load any number of load modules produced by the Series 1600 
Symbolic Cross Assembler (S16XAL) or Object Module Linker (S16LNK). 

Prior to program execution, the user may redefine memory blocks as Read 
Only (ROM), modify access times, and change word size. Up to 8 sets of 
parameters are accommodated. In addition, the upper and lower limits of the 
memory stack area can be defined. The S16SIM Simulator issues various error 
messages based on these memory definition values. 

During program execution, the S16SIM Simulator generates a pseudo real time 
execution clock which is used to schedule simulated input/output and interrupt 
activities. The microprocessor cycle time can be varied from its 400 nsec de- 
fault value to simulate different system speeds. The memory access times and 
the microprocessor cycle time determine if delays are required while waiting 
for memory accesses. If the microprocessor cycle time is 400 nsec, then memory 
access times from 1-700 nsec produce no wait, from 701-1100 nsec produce 1 
wait cycle, 1101-1500 nsec produce 2 wait cycles, etc. 

3.6 CONTROL COMMAND SEQUENCE 

After program load and environment definition, the program can be executed or 
single -stepped. Appropriate commands may be entered to display registers or 
memory locations; search memory for bit patterns; or modify registers or mem- 
ory. A table is kept of the last 10 program execution addresses in order to allow 
the user to retrace program flow. When the simulator is ready for input commands 
the message /'ENTER COMMAND'' is displayed; after the programmer has com- 
pleted his input he may continue simulation with a Continue (C), Step (S), or 
Execute (E). The C will remain in either the Step or Execute mode while the S 
and E will reset the mode. 



When in the execute mode the simulation may be interrupted by depressing the 
"Break" key on the console. 

3.7 TRAPS AND TRACES 

The S16SIM Simulator provides program monitoring capability on CPU registers 
0-7 and on any bus address. A trace provides a dynamic display of activities 
when specified conditions are met. A trap provides a suspension of program 
execution, i.e., a breakpoint, when specified conditions are met. Since register 
7 serves as the CPU program counter, a trap on register 7 serves as a program 
trap or breakpoint and a trace on register 7 serves as a program flow trace. A 
memory address trap on a specific address may also serve as a breakpoint when 
a memory address is accessed during execution. Both traps and traces are in- 
spected after the instruction is executed. 

3.8 INPUT/OUTPUT AND INTERRUPT SIMULATION 

S16SIM providesfor simulation of up to eight input/output devices and up to eight 
ext ernal interrupts . These activities are controlled by tables which specify when 
such events are to occur relative to real execution time. During program simu- 
lation, execution time is accumulated and used to schedule I/O operations and 
interrupts. This scheduling is relative to zero time, i. e. , the start of program 
execution. 

Interrupts are scheduled by defining the start time and the repitition rate. Input/ 
output simulation is provided for through use of data register and status register 
tables. If a polled or sensed device is to be simulated, it is defined by corres- 
ponding entries in both data and status register tables. The status register table 
defines when and how a device becomes ready, while the data register table de- 
fines the data source or destination. If an interrupt driven device is to be simu- 
lated it is defined by entries in the interrupt table and the data register table. The 
eight simulated I/O devices correspond to eight data files named: S16SIMOn, where 
n is to 7. If input is to be simulated, the corresponding data file must be cre- 
ated by the user beforehand. Output files are created and extended during simula- 
tion. When output occurs on a file which already exists, it is deleted and a new file 
is created with the same name. 

3.9 EXTERNAL CONDITION SIMULATION 

S16SIM provides for simulation of 16 external sensed conditions. In a real system 
configuration four lines derived from the four lower bits of the BE XT instruction 
are available at CPU output pins. These signals may be decoded externally to ob- 
tain up to 16 test points with the selected one being returned to the CPU for the 
branch decision, ia order to sirfiulate these external sensing activities, a 16 posi- 
tion table is used to control when each of the possible 16 decodes is to be true or 
false. In a manner similar to I/O and interrupt simulation, the external condition 
activities are scheduled relative to program execution time accumulated since the 
start of execution. The external conditions are scheduled by defining a start time 
and with what repetition rate they are to occur. In addition, the logical condition 
of individual external conditions when active or ready may be specified as true 



(high) or false (low). An external condition not defined by a table entry always 
results in a false evaluation. 

3.10 TELETYPE SIMULATION 

The input /output of ASCII characters from and to an ASR-33 teletype machine or 
equivalent is simulated without timing via bus addresses 167774-167777. The 
TTY is simulated during program execution by the user terminal which functions 
in a character by character mode. All other terminal activities are record, 
i.e., line oriented. 

Bus addresses 167774 and 167776 simulate the TTY keyboard and printer status 
registers respectively. Input from either of these addresses always returns 
000001, indicating device ready. Bus address 167775 simulates the TTY keyboard 
data buffer register while bus address 167777 simulates the TTY printer data 
buffer register. Data input from the TTY is always 7 bit ASCII and data output 
to the TTY must always be 7 bit ASCII. Note that character literal data generated 
by the S16XAL assembler is 7 bit ASCII compatible with TTY data. 

3.11 COMMAND STRING FORMAT 

S16SIM interactive command strings must comform to a format which always 
contains a keyword or verb and seven elements which may be optional depending 
on the nature of the command verb. The general command string format is: 

VERB, n ; ei , e2 , es , e4 , es . 

The indicated element separators, i.e., commas and semicolon, must be used 
as shown. Command strings are limited in length to 60 characters and must be 
complete on one line. 

S16SIM recognizes a set of control commands which are entered on the terminal 
keyboard in response to the "ENTER COMMAND*' display. If a command is entered 
which cannot be recognized, a question mark (?) is displayed under the question- 
able area of the command and ''ENTER COMMAND" is again displayed. 

In the following descriptions, required command string elements are underlined, 
optional elements are not underlined and ^ represents a carriage return. Com- 
mand elements to the right of the semicolon (;) may be symbols from a S16XAL 
assembly, literals or expressions composed of symbols and literals. 

Expression operators may be addition (+) and subtraction (-). Command elements 
indicated by n which are to the left of the semicolon (;) must be literals. Literals 
may be octal, decimal, hexadecimal, or ASCII and are expressed as follows: 



OCTAL - soooooo (Default Radix) 

s = optional +or -, + assumed 

d = 0-7 

000000 = to 177777 

DECIMAL - s.ddddd 

. = deciihal indicator 
ddddd = -32768 to +37767 

HEXADECIMAL - sX'hhhh' 

s = optional + or -, + assumed 
X' ' = hexadecimal indicator 
hhhh = to FFFF 

ASCII - 'cc' or "cc" 

*or'* = delimiters 

c - any ASCII character 

One or two characters are packed into each 16 bit word. 

If one character is specified (*'c'' or 'c') it is placed in 

the low order byte of the word with zeros in the high 

order byte. 
If two characters are specified (''ab*' or 'ab') the first 

(a) is placed in the low order bj^e and the second (b) 

is placed ui the high order byte. 

In the following descriptions ''ENTER COMMAND*^ and '':'' serve as user 
prompts, i. e. , the user must respond with a keyboard entry. After each com- 
mand action is completed by S16SIM, the user is again prompted. 

3. 12 LOADING AND SYSTEM PARAMETER DEFINITIONS 



3. 12. 1 Load Binary Program 

ENTER COMMAND 

: LOAD , n^ 

ENTER BINARY FILE NAME, 

ACCOUNT 
: name, account 1 



Load indicated S16XAL generated binary 
program file at address n, if n is not 
specified the program will be loaded at 
the assembly base address. If the file 
exists in the current account, the account 
may be omitted. Any number of binary 
program files may be loaded. 



3.12.2 Set Data Display Radix 

o^ 



ENTER COMMAND 
:RADX, n 



Octal radix = 8, decimal radix = 10, 
ASCII = 0, hexadecimal radix =16. If no 
radix is specified, octal is used. 



3.12-3 Set Time limit 



:TUM, t 



3.12.4 



3.12.5 



Set program execution time limit of t 
microseconds. Program execution will 
be suspended after t microseconds have 
been accumulated. If t is not specified, 
the tinie limit is removed. 



Display / Modify CPU Clock Rate 

ENTER COMMAND 

:CLKy 

CLK ~ mum Nsec 

:mmn^ 



If nnn is entered the Clock rate will be 
changed. If only a carriage return is entered 
the clock rate will not be changed. 



Define Memory 

ENTER COMMAND 

:RAM, n ; addl, addh, t, b, f / Define a Read /Write Memory Block. 

n Position in the memory table for this entry. 

If not specified, the memory definition is 
added to the end of the table until eight 
(0-7) definitions have been accumulated. 
If more than eight memory definitions are 
specified, the most recent is replaced. 



addl 



addh 



Low bus address assigned to memory 
segment n. 

High bus address assigned to memory 
segment n. 

Memory access time in nanoseconds. If 
not specified, the current CPU clock rate 
is used. 

Fill mode, if word size is less than 16 bits, 
f specifies how data is read out of memory. 
If f is not specified, mode is assumed. 

- right justified, O's left fill. 

1 - right justified, I's left fill. 

2 - right justified, sign bit extension. 

3 - left justified, o's right fill. 

4 - left justified, I's right fill. 



3.12.6 Remove Memory Definition 

ENTER COMMAND 
: RAM, n / 

or 
ENTER COMMAND 
: ROM, n / 

In the above command strings if n is specified, the corresponding mem- 
ory definition table entry will be removed. If n is not specified all en- 
tries will be removed. 

3 . 12 . 7 Display Memory Blocks 



ENTER COMMAND 
: DMB / 



The memory block table will be dis- 
played with all associated definitions. 



3.12.8 Set Stack Limits 

ENTER COMMAND 
: SUM ; addl, addh y 



Set the lower stack limit to address add 1 and 
the upper stack limit to address addh. 
Program execution is suspended if the 
stack pointer (R6) exceeds these limits. 



3 . 12 . 9 Remove Stack Limits 



ENTER COMMAND 
: SUM / 



Remove stack limits. 



3.12. 10 Display Maximum Stack Used 

ENTER COMMAND 
: DMXS J 



MAX STACK = X X X X X X 



X X X X X X is the maximum value that the 
stack pointer reached during execution. 



3.13 BASIC CONTROL COMMANDS 

3 . 13 . 1 ENTER COMMAND 
: E ; addri, addrf a 



Execute a program beginning at location 
addri and suspend execution when addrf is 
reached. If no addri is specified, execution 
begins using the current value of the program 
counter (register 7). If no addrf is specified, 
execution continues until: a HALT instruction 
is executed, a *'BREAK'' interrupt is issued 
by the user via the terminal keyboard, the 
execution time limit is exceeded, or a trap 
condition is reached. 



3 . 13 . 2 Execute and Display Registers 



ENTER COMMAND 
: EDR ; addri, addrf 



y 



Same as above, except the registers are 
displayed after each instruction is exe- 
cuted. 



3.13.3 Step 

ENTER COMMAND 
: S ; addr^ 



Step (one instruction at a time) a program 
beginning at location addr. If no addr is 
specified, the program is stepped using 
the current value of the program counter 
(register 7). 



3.13.4 Continue 



ENTER COMMAND 



Continue program execution from current 
location. C is used when in STEP mode, 
after a TRAP or after a ''HLT" instruction. 



3.13.5 



Exit 



ENTER COMMAND 



Exit from S16SIM to the operating system 
Monitor . 



3 . 13 . 6 Keyboard Interrupt 
"BREAK" 



3 . 13 . 7 Display Elapsed Time 

ENTER COMMAND 
: DET I 



One depression of the "BREAK" Key gener- 
ates an interrupt to the S16SIM executive. 
This interrupt can be used during simulation 
to suspend program execution or to suspend 
extended terminal outputs requested by DA 
or SA commands. If the interrupt is issued 
during program execution, "BREAK" will be 
displayed followed by the ENTER COMMAND 
request. If the interrupt is issued during a 
non execution activity, the activity will be 
suspended and the ENTER COMMAND re- 
quest will be displayed. 



Display program execution time in micro- 
seconds. 



3 . 13 . 8 Display Registers 



ENTER COMMAND 
: DR 



3.13.9 Display Addresses 

ENTER COMMAND 
: DA ; addrl, addrh / 



3. 13. 10 Search Addresses 



Display the current contents of: Registers 
0-7; status register bits S, Z, C, OV; 
INTFF and NONINT. 



Display the current contents of bus locations 
addrl through addrh inclusive. If addrl 
and addrh are not specified all bus locations 
are displayed. 



ENTER COMMAND 

: SA ; addrl, addr2, value , masly Search bus locations addrl through 

addr2 inclusive for value using mask to '*and'' 
out corresponding bits. If value and/or 
mask are not specified, and 177777 are 
used. 



3.13.11 Initialize Addresses 

ENTER COMMAND 

: lA, addrl, addr2, value, mask/ 



3.13.12 Display/Modify Addresses 



ENTER COMMAND 
: A ; addr^ 
nnnnnn = 
innnnnn. 



V 

nnnnnn 



Initialize bus locations addrl through 
addr2 inclusive using value and mask to 
set bits. If value and/or mask are not 
specified and 177777 are used. 



Open bus address addr for display and 
modification. 

If no ; addf is specified, address is opened, 
if the contents of the currently open address 
is to be changed, the new value is entered 
followed by optional ''x" and a carriage re- 
turn. If no change is to be made, only 
optional ''x*' and a carriage return is entered. 
The character ''x'' represents either / or + 
and -. These characters are used to indi- 
cate if the next address (/ or +) or the pre- 
vious address (-) is to be opened after the 
current location is closed. If no "x'' is 
specified the current location is closed. 



3.13.13 Display /Modify Registers 



ENTER COMMAND 
: R, ly 
Rn = nnnnnn 
: nnnnn / 



Open registers n (0-7) for display and 
modification. If no n is specified, RO 
is opened. If the contents of the currently 
open register is to be changed, the new 
value is entered followed by optional "x" 
and a carriage return. If no change is to be 
made, only optional *'x'* and a carriage re- 
turn is entered. The character "x*' repre- 
sents either / or H-and -. These charac- 
ters are used to indicate if the next register 
(/ or +) or the previous register (-) is to 
be opened after the current register is 
closed. 



3.13.14 Display/Modify Status Register 

ENTER COMMAND 
;SRj 

S= N 
: n 

Z = N 
: n 

C= N 
: n 

C= N 
: n 

OV = N 
: n 



Open status register S, Z, C, OV bits for 
display and modification. 

After the current value of each bit is displayed 
(N), a new value (n = or 1) may be entered. 
If no change is to be made, only a carriage 
return is entered. 



3 . 13 . 15 Branch Destination Modification 



ENTER COMMAND 
: MB ; addrl, addr2 






Modify branch instruction at addrl and 
addrl + 1 for destination addr2. 



3 . 13 . 16 Jump Destination Modification 

ENTER COMMAND 
: MJ ; addrl, addr2^ 



Modify jump instruction at addrl, addr + 1 
and addrl + 2 for destination addr 2. 



3 . 13 . 17 Display Symbols 
L C 



ENTER COMMAND 
: DSYM 



Display the current symbol table. 



3 . 13 . 18 Display Previous Addresses 



ENTER COMMAND 
: DPA , 



Display the 10 most recent program 
counter (R7) values. 



3 . 13 . 19 Clear Previous Addresses 



ENTER COMMAND 
: CPA y 

3,13.20 Set Software Interrupt Vector 

ENTER COMMAND 
: SIN ; addr/ 



Clears the 10 most recent program counter 
(R7) values. 



Specify SIN (software interrupt) vector ad- 
dress. If a SIN is executed and no vector 
address is specified, the instruction is exe- 
cuted as a NOP. The current vector can be 
deactivated by entering only the command. 



3.14 TRAP/TRACE COMMANDS 

3.14.1 Memory Trap or Trace 

ENTER COMMAND 

: MT , n ; addr , mode, f, v, mj 



Set memory address trap or trace. 



n=0-7 



addr 

mode = 

1 
2 
3 



m 



MT number; if not specified each MT will be 
accumulated until MT 7 has been specified. 
Subsequent MT entries will then be accumu- 
lated by replacing the current MT 7 entry. 

address at which a trap (breakpoint) is to be 
set or which is to be traced. 

trap when addr is referenced. (Default con- 
dition) 

trace when addr is referenced. 

trap when contents of addr are changed. 

trace when contents of addr are changed. 

frequency of occurence, i.e., the number of 
times the specified condition will be satisfied 
before the trap or trace is activated. De- 
fault value 1. 

value of contents of addr which will activate 
trap or trace. Default, unconditional trap 
or trace. 

Mask used to extract a value to be compared 
with V. Default value 177777. 



3.14.2 Register Trap or Trace 



ENTER COMMAND 

: RT, n ; mode, f, v, mi Set register trap or trace. 



n = 0-7 Register number. 

mode = trap when register n is referenced. (Default 

condition) 

1 trace when register n is referenced. 

2 trap when contents of register n are changed. 

3 trace when contents of register n are changed. 

f frequency of occurrence, i. e. , the number of 

times the specified condition will be satisfied 
before the trap or trace is activated. De- 
fault value 1. 

V value of register n which will activate trap 

or trace. Default, unconditional trap or 
trace. 

m mask used to extract a quantity to be com- 

pared with v. Default, 0177777. 

3 . 14 . 3 Remove Register Trap or Trace 

ENTER COMMAND 

: RT , n i Remove Register n trap or trace. If n is not 

specified, all register traps or traces are 

removed. 

3 . 14 . 4 Remove Memory Trap or Trace 

ENTER COMMAND 

: MT , ny Remove memory address trap or trace n. 

If n is not specified, all memory address 
traps or traces are removed. 

3.14.5 Display Register Traps or Traces 

ENTER COMMAND 

:DRT, n / Display register trap or trace table entry n. 

If n is not specified all entries in the table 

are displayed. 

3.14.6 Display Memory Traps or Traces 

ENTER COMMAND 

:DMT, n i Display memory address trap or trace table 

entry n. If n is not specified all entries in 

the table are displayed. 



3.15 INPUT/OUTPUT COMMANDS 



3.15.1 Define I/O Buffer Register 

ENTER DOMMAND 
:IOBR, n;addr, dy 

n 



addr 
d 



Define an I/O buffer register. 

Entry in buffer register table. If not speci- 
fied the buffer register is added to the end 
of the table until ei^t (0-7) definitions have 
been accumulated. If more than ei^t buffer 
registers are defined, the most recent is 
replaced. 

Buffer register bus address. 

The direction of data transfer, = output, 
1 = input. If not specified output is assumed. 



3 . 15 . 2 Remove I/O Buffer Register Definition 



ENTER COMMAND 
:IOBR, ny 



Remove buffer register definition n. If n is 
not specified, all buffer register definitions 
are removed. 



3.15.3 Display I/O Buffer Register Table 



ENTER COMMAND 
:DIOB i 



Display the I/O Buffer Register Table. 



3.15.4 Define I/O Status Register 

ENTER COMMAND 
:IOSR, n;addr, r,time, rate J 

n 



addr 
r 

time 

rate 



Define an I/O status register. 

Entry in status register table. If not specified 
the status register is added to the end of the 
table until eight (0-7) definitions have been 
accumulated. If more than eight status reg- 
isters are defined the most recent is replaced. 

Status register bus address. 

The contents of the status register when ready. 
No ready is the complement of r. If r is not 
specified, zero is used. 

Time of the initial ready state in microseconds. 
If not specified the status register will become 
ready after the first instruction is executed. 

Rate at which the status register subsequently 
becomes ready in microseconds after (time). 
If not specified the status register will ready 
after the next instruction. If rate is equal to 

zero the status register will ready only once 
(time). 



3.15.5 Removal I/O Status Register Definition 



ENTER COMMAND 
: IOSR , n / 



Remove status register definition n. If n 
is not specified, all buffer register defini- 
tions are removed. 



3.15.6 Display I/O Status Register Table 



ENTER COMMAND 
:DIOS , 
/ 

3.15.7 Define Interrupt 



ENTER COMMAND 

: INT, n;addr, time, rate y 

n 



addr 
time 



rate 



3.15.8 Display Interrupt Table 



ENTER COMMAND 
DINT^ 



^/ 



3 . 15 /9 Remove lateritopt Definition 

ENTER COMMAND 

: INT , ny 



Display I/O Status Register Table. 



Define an interrupt. 

Entry in interrupt table. If not specified, 
the interrupt definition is added to the end 
of the table until eight (0-7) definitions have 
been accumulated. If more than eight in- 
terrupt definitions are specified, the most 
recent is replaced. The position in the table 
represents the relative interrupt priority, 
i. e. , 0-7 with 7 having the bluest priority. 

Interrupt vector address. 

Time of the initial occurrence of interrupt 
in microseconds. If not specified the in- 
terrupt will occur immediately after the ex- 
ecution of the first instruction which enables 
interrupts . 

Time of interrupt re-occurrence in micro- 
seconds. If not specified the interrupt will 
occur at the maximum rate possible, i. e. , 
after every instruction which enables in- 
terrupt. If rate is equal to zero the in- 
terrupt will occur only once at (time). 



Display Interrupt Table. 



Remove interrupt definition n. If n is not 
specified, all interrupt definitions are re- 
moved. 



3 . 16 EXTERNAL CONDITION COMMANDS 



3. 16. 1 Define External Condition 



ENTER COMMAND 
:EXT, n;ext, time, rate 



n 



ext 



time 



rate 



Define an external condition. 

External condition (0-15) which corresponds 
with an appropriate BE XT instruction. If n 
is not specified, each EXT definition is ac- 
cumulated starting with EXTO until EXT 15 
has been defined. Additional definitions 
will then replace EXT 15. 

The logical condition of the external condi- 
tion when ready, = false, 1 = true. When 
not ready the external condition is in the 
complement condition. 

Time of the initial ready state in micro- 
seconds. If not specified, the external con- 
dition will become ready after the first in- 
struction is executed. 

Rate at which the external condition sub- 
sequently becomes ready in microseconds 
after (time). If not specified the external 
condition will remain ready. If rate is 
equal to zero, the external condition will 
ready only once at (time). 



3. 16. 2 Remove External Condition Definition 



ENTER COMMAND 
: EXT, n / 



Remove external condition definition n. If 
n is not specified, all external condition 
definitions are removed. 



3.16.3 Display External Conditions Table 



ENTER COMMAND 
:DEXT J 



Display the External Condition Table. 



3.17 INFORMATIVE MESSAGES 

During program debugging and simulation using S16SIM, certain conditions may occur 
which cause one or more of the following messages to be displayed on the terminal: 

UNDEF BUS ADDR =xxxxxxxPC = YYYYYY 

A reference to an undefined bus address has been detected. Program 
execution is suspended. 

ILL ROM WRITE BUS ADDR = x x x x x x BUS DATA = YYYYYY PC = ZZZZZZ 

An attempt to write into a bus address defined as read only memory has 
been detected. Program execution is suspended. 

INVALID ADDRESS, LOAD ABORTED 

A program load resulted in reference to an undefined memory address. 
The load is terminated at that address. 

"HLT" ATxxxxxx 

A halt instruction has been executed, program execution is suspended. 

"BREAK^* 

The *'BREAK" Key on the user terminal was depressed during program 
execution. Program execution is suspended. 

REGn TRAP CONTENTS =xxxxxx PC = YYYYYY 

REGn TRAC CONTENTS =xxxxxx PC = YYYYYY 

A reference to a CPU register which has been specified in the register 
trace and trap table has been detected. A trace allows program execution 
to continue, while a trap suspends program execution. 

MEM ADDR TRAP nATxxxxxx DATA = YYYYYY PC = ZZZZZZ 

MEM ADDR TRAC nATxxxxxx DATA = YYYYYY PC = ZZZZZZ 

A reference to a memory address which has been specified in the memory 
address trap and trace table has been detected. A trace allows program 
execution to continue, while a trap suspends program execution. 



"SDBD" PRECEDES NON DEL BYTE DATA INSTR, PC = x x x x x x 

The double byte data flip flop was set during execution of a non double 
byte data instruction. The flip flop is cleared and program execution 
continues. 

STAK LIMIT VIOLATION, PC=xxxxxx SP = xxxxxx 

The stack pointer, R6, has exceeded the currently specified stack 
limits. Program execution is suspended. 

"TIME LIMIT" AFTER x x x x x x x USEC 

The user specified simulated execution time limit has been exceeded. 
Program execution is suspended. 

EIS & DIS SET ON JSR OR J INSTR AT x x x x x x IGNORED 

Both interrupt enable and disable bits were detected set during execution 
of a JSR or J instruction. Interrupts are unchanged and program execution 
continues. 

CANNOT RELOCATE ABS BINARY FILE, LOAD ABORTED 

The user has requested load relocation on a binary file generated by an 
absolute assembly. 

DEVICE DATA EXHAUSTED AFTER n INPUTS BUS =xxxxxx PC = YYYYYY 

More data has been requested from a simulated input device than the 
device data file contains. Program execution is suspended. 

BUS ADDRx X X X X X CONFLICT 

An attempt to redefine a bus address which is already defined. The 
current bus address definition is not affected. 

MEMORY BLOCK FROM x x x x x x TO YYYYYY CONFLICTS WITH PREVIOUS DEFINITION 

An attempt to redefine a memory block which is already defined. The 
current memory block definition is not changed. 



DATA WORD SIZE, ADDR = x x x x x x, DATA = YYYYYY, PC = ZZZZZZ 

An attempt to write into memory with data which is greater in magnitude 
than the defined memory word size. Program execution is suspended. 

OUTPUT TO TTY OF NON ASCII CHAR xxxxxx PC = YYYYYY 

An output to the simulated teletype at bus address 177777 of a non 
ASCII character has been detected. The character is replaced by an 
ASCII blank and program execution continues. 

INPUT FROM TTY OF NON ASCII CHAR xxxxxx PC = YYYYYY 

A non ASCII character has been received from the simulated teletype 
at bus address 167775. The character is replaced by an ASCII blank 
and program execution continues. 

OUTPUT TO INPUT BUFFER REG xxxxxx BUS DATA = YYYYYY PC = ZZZZZZ 

An output to a buss address defined as a simulated device input buffer 
register has been de acted. Program execution is suspended. 

INPUT FROM OUTPUT BUFFER REG x x x x x x PC = YYYYYY 

An input from a buss address defined as a simulated device output buffer 
register has been detected. Program execution is suspended. 



CHAPTER 4 
S16XRF CONCORDANCE (XREF) GENERATOR 

4.1 INTRODUCTION 

The Series 1600 Concordance Generator program (S16XRF) provides the user 
with a concordance or cross reference listing of Series 1600 assembly language 
programs. A cross reference listing consists of program statement symbols 
and all references to each symbol. Cross reference listings are useful when 
debugging and modifying large programs. 

4.2 OPERATION 

S16XRF produces a symbol cross reference listing of Series 1600 assembly 
language source program by reading the source file and noting all sjmLibols and 
references. A listing is then produced which indicates each symbol, the line 
number on which each sjnnbol is defined and all references to each sjnfnbol by 
ascending line number. The sjmibols are listed in alphabetical order down the 
page while the line numbers of all references are listed across the page. 

4.3 INTERACTIVE DIALOGUE 

Upon initial startup, S16XRF identifies the version in use and then requests 
identification of the assembly language source file for which the cross reference 
listing is to be produced by displaying: SOURCE FILE, ACCNT? The user must 
then enter the name of an appropriate file followed by a comma and the file ac- 
count or user code. If the file exists in the current account, the comma and ac- 
count may be omitted. Next, the user is requested to specify a listing file by the 
message: LIST FILE? If the user enters a file name, the symbol cross refer- 
ence listing will be output to the named file. If no file is named, i. e. , only a 
carriage return is entered, the listing will be output on the user's terminal. 

4.4 ERROR MESSAGES 

If the named source file does not exist as specified, the message *TILE DOES 
NOT EXIST!" is displayed and another source file is requested. 

If the named source file contains more sjmabols than can be assommodated by the 
version of S16XRF in use, the message "TOO MANY SYMBOLS AT LINE # nnnn!" 
is displayed. In this case the cross reference listing will not contain symbol 
references on or after the indicated line number. 

4.5 LISTING FORMAT 

The symbol cross reference listing which is produced by S16XRF contains 
symbols in alphabetical order and references to each symbol in numerical order 
as follows: 



SYMBOL UNE # REFERENCES 

MAX 

NUMBER 

QTY 

Z 

4,5 UMITATIONS 

S16XRF-1 (Version 1) can accommodate 300 symbols and 1200 symbol refer- 
ences. These limitations are related to the size of the memory available on 
the particular host computer in use. 
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CHAPTER 5 
S16BPT BINARY PAPER TAPE GENERATOR 

5.1 INTRODUCTION 

The Series 1600 Binary Paper Tape Generator program (S16BPT) is used to 
punch on paper tape an object module file produced by the Series 1600 
Symbolic Cross Assembler (S16XAL) or a load module file produced by the Series 
1600 Object Module linker (S16LNK). A paper tape is required when a program 
which has been assembled and/or linked on a host computer system is to be 
loaded and executed on a Series 1600 microprocessor system. The format of the 
tape produced is compatible with the Series 1600 Relocating Linking Loader* 

5.2 OPERATION 

Upon initial startup (via appropriate host system Run or Execute command) 
S16BPT identifies the current version in use and requests object file identification 
by the message: '^ENTER BINARY FILE NAME, ACCNT*^. The user must enter 
the name of an appropriate Series 1600 binary file followed by a comma and the 
filers account identification. On many systems if the file exists in the current 
account, the comma and account may be omitted. Next, the user is requested 
to ready the paper tape punch and acknowledge when ready. When the paper tape 
punching is complete, the user is requested to enter another file to be punched; 
if only a carriage return is enterB«J, control is returned to the host computer 
operating system monitor. 

5.3 ERROR MESSAGES 



Several error conditions are detected by S16BPT and are reported to the user by 
the following messages : 

FILE DOES NOT EXIST!! - the named object file does not exist, enter another 
file name. 

INVALID OBJECT CODE SEQUENCE, TAPE ABORTED!! - the named object file 
contains erroneous or invalid object data, tape aborted. 



CHAPTER 6 
S16RTG ROM TAPE GENERATOR 

6.1 INTRODUCTION 

The Series 1600 ROM Tape Generator program (S16RIG) produces data 
from which Read Only Memories for the CP-1600 microprocessor are 
fabricated. A load module produced by the Series 1600 Cross Assembler 
(S16XAL) or the Series 1600 Object Module Linker (S16LNK) is converted 
to data patterns which are input to General Instrument Corporation's auto- 
mated ROM manufacturing facility for processing. 

6.2 OPERATION 

l^on initial startup (via appropriate host system RUN or EXECUTE 
command), S16RTG identified the current version in use and requests 
load module identification by displaying" LOAD MODULE NAME, ACCT?". 
The user must enter the file name of the load module which is to be 
placed on a ROM followed by a comma and the file's account identifica- 
tion. On many host systems, if the file exists in the current account, 
the comma and account identification may be omitted. Next, the user 
is requested to enter a program relocation address by the message: 
'^RELOCATION ADDRESS?". S16RTG includes a program relocation facili- 
ty so that the load module need not be assembled at the actual ROM ad- 
dresses. The user is next requested to specify a name for the ROM 
data pattern file which is to be produced by the display: "ROM PATTERN 
FILE NAME?". The user must enter a suitable file name of one to ei^t 
characters, with the first alphabetic (A-Z) and the rest alphanxmieric 
(A-Z, 0-9). S16RTG produces a EBCDIC or ASCII sequential ROM data 
pattern file of 129 ei^ty character records which may be transferred to 
punched cards, magnetic tape or paper tape for transmittal to General 
Instrument Corporation for ROM processing. Next, the user is requested 
to enter a ROM pattern number by the message: '^ROM PATTERN 
NUMBER?". This three digit number is used to identify the ROM patterns 
during processing and must be obtained from General Instrument Corporation 
prior to producing the ROM pattern file. Finally, the user is requested to 
specify the particular ROM base address by the message: "ROM BASE 
ADDRESS?". This address is the one at which S16RTG will commence 
producing data patterns and must be equal to or greater than the reloca- 
tion address and have the three least significant octal digits equal to 000. 
The 512x10 bit ROMs are assigned addresses xxxOOO - xxx777. When 
file generation is complete, another load module file name is requested. 
If a name is entered the process is repeated, if, however only a carriage 
retxirn is entered, control is returned to the host computer operating system 
monitor. 

6.3 ERROR MESSAGES 



Several error conditions are detected by S16RTG and are reported to the 



user by the following messages: 

STRING ERROR!! - The load module file name, account specification 
contains an error. 

FILE DOES NOT EXIST!! - The specified file does not exist. 

FILE NAME CONFLICT!! - The specified ROM pattern file name is 
the same as the specified load module file name. 

NON SEQUENTIAL ADDRESSING IN ROM, ZEROS USED IN UNDEFINED 
ADDRESSES - The load module contains a RES or an ORG assembly 
directive, resulting in unspecified contents for ROM locations. It is 
recommended that the user use the ZERO assembly directive for speci- 
fying unused ROM locations. 

LOAD MODULE CONTAINS LINKAGE INFORMATION, ROM ABORTED!! - 
The specified load module was not a load module, but probably an object 
module. 

ABS LOAD MODULE, CANNOT RELOCATE, ROM ABORTED!! - The 
user has requested relocation of an ABS assembly load module. 



APPENDIX A 
SAMPLE S16XAL ASSEMBLY 



The listing shows a sample assembly performed by the S16XAL 
Sjrmbolic Cross Assembler. The program is a generalized code 
conversion utility routine. A number of intentional errors have 
been incorporated into the source program to show the error 
diagnostics of the S16XAL Assembler. 
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SSS, DDD 

DDD 

DDD 

DDD 

DDD 

DDD 

DDD 


6* 

6* 

7 

6 

6 

6 

6 

6 

6 

6 

6 

6 

6 

6 


0010 SSS DDD 
0010 SSS SSS 

0010 SSS 111 

0011 S58S DDD 

0100 SiSS DDD 

0101 SSS'^ DEH>^ 

0110 SSS DDD 

bin sas DDD 

0111 DDD DDD 
0000 dor DDD 
OCKX) 010 DDD 
0000 Oil DDD 
0000 100 DDD 
obob 101 DDD 


MOVe contents of Register SSS to register DDD. *If DDDis6or 7 add 1 to Cycles. 
TeST contents of Register SSS. *If SSS is 6 or 7 add 1 to Cycles. 

Jutnp to address in Regi^er SSS. (Move address to Register 7). 

ADD contents of Register SSS to contents of register DDD. Results to ^^ro 
SUBtract of Register SSS from contents erf register DDD. Results to Dpb _ 
CoMPire Register SSS with register DDD by subtraction. Results not stored^ 
logical At*^ contents of Register SSS with contents of register DDD.Results to DDD 
eXciuJBive OR contents of Register SSS with contents of register DDD. Results to DDE 
CLeaR Register to zero/ 

INCrement contents of Register DDD. Results to DDD 
DECremeitt contents of Register DDD. Results to DDD 
one's COMplement contents of Register DDD. Results to DDD 
_,Tw<>'a complemeift contents of Register DDD. Results to DDD 
ADd Carry bit to contents of Register DDD. Results to DDD 


S, Z 
S, Z 
S, Z 
S, Z, C, OV 

s, zvcov— 


S, Z, C, OV 
S, Z 
S, Z 
S, Z 

s, z 


s, z 
s, z 
s, z, c, ov ' 


s, z, c, ov 


REGISTER SHIFT Executable only with Register 0, 1, 2, 3. 

Shift Right instructions set the S flip-flop with Bit 7 of the result after the instruction. 
Add 2 cycles if shift is 2 bits or two bytes. 
Shifts are iK}t interrt^ytable. 


SWAP 

sll" 

RLC 

SLLC 

SLR 

SAR 

RRC 

SARC 

\ 

1 ! 


RR<,a> 

RR<n> 

RR<n> " 

RR<:Sn> 

RR<Cn> 

RR<n> 

RR<h> 

RR<n> 


6 

8 


0001 000 NRR 


N == 0, SWAP bytes of register RR. S equals Bit 7 of results of SWAP. 
N - 1, SWAP bytes of register RR, then swap them back to original form. 


s, z 
s, z 


r 6 

^ 8 
6 
8 

8 
6 
8 
Y" 

8 

' '6" """ 

8 
6 
8 


0001 001 NRR 
0001 010 NRR 

bobi on NRR 


N = 0. Shift Lc)gical Left one bit, zero to low bit. 
N=„l, Shift Logical Left two bits, zero to low 2 bits. 


s, z 
s, z 


N - 0, Rotate Left one bit using Carry bit as bit 16. 

N - 1, Rotate Left two bits using C as bit 17 and OV as bit 16. 

N « 0, Shift Logical Left one bit using C as bit 16, zero to low bit. 

N » 1, aiift Loijical Left two bits using C as bit 17, OVas bit 16, zero to low 2 bits. 


s, z, c 
s, z, c, ov 


s, z, c 
s. z, cov 


0001 100 NRR 


N * 0, Shift Logical Right one bit , zero to hig^ bft. 

N = 1, aiift Logical Right two Wts, zero to high two bits. 


s, z 
s, z 


0001 101 NRR 


N = 0, Shift Arithmetic Right one bit, sign bit coj^ed to high bit. 
N « 1, Shift Arithmetic Right two bits, sign bit copied to higji bits. 


s, z 
s, z 

15V Z,G - 

s, z, c, ov 


0001 110 NRR 
0001 111 NRR 


N = 0, Rotate Rig^t one bit using Carry as bit l6 . 
N« 1, Rotate Rig^t two bits using C as Mt 16, OV as bit 17/ 
N = 0, Shift Arithmetic Right one bit, thru Carry, sign bit copied to high bit. 
N - 1, Shift Arithmetic Rig^ two bits, thru Carry and OV, sign bit copied to high 

2bit8 


s, z, c 
s, z, c, ov 
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•BRANCHES 



AH>ENDIX B 
1 NSTJ< UCTIQN SET (continued) 

The Branch instructions are Program Couitfser Relative* i. e. , the Effective Address - PCj^Displacement. PPPPH^PPPP is the Disnlacenient and S 
is for -f, 1 for -. If Memory is greater than 10 bits then the appropriate number of lead bits pppppp will be a part of the Displacement. For a fytymd 
branch an addition is performed; for a backward branch a ones complement subtraction is performed. Computation performed on PC+2. 



MNEMONIC 1 


OPERAND 


CYCLES 


INSTRUCTION | 


DESCRIPTION 


^ STATUS CHANGE 


B 


DA 


7/9 


1000 


so 


0000 


Branch unconditional^ Program Counter Relative (+102 5 to -1024) 










pppppP: PPF? 


PP 


PPPP 






NOPP 




f 


1000 
PPPPPP PPPP, 


so 
PP 


1000 

pppp 


No operation, two words 




BC 


DA 


7/9 


1000 


so 


0001 


Branch on Carry- C = 1 




BLGT 


DA 




pppppp PPPP 


PP 


pppp 


Branch if Logical Greater Than. C = 1 




BNC 


DA 


7/9 


1000 


so 


1001 


Branch on No Carry. C = 




BLLT 


DA 




Pppppp PPPP 


PP 


pppp 


Branch if Logical Less Than. C =0 




BOV 


DA 


7/9 


1000 
PPPPW> PPPP 


so 
PP 


(K)10 

pppp 


Branch on Overflow. OV = 1 




3NDV 


DA 


7/9 


1000 


so 


1010 


Branch on No OVerflow. O V = 










PPPPRJ PP?P 


PP 


pppp 






BPL 


DA 


7/9 


1000 
PPPPPP PPPP 


so 
PP 


0011 

pppp 


Branch on PLus. S = 

■ 




BMI 


DA 


7/9 


1000 


so 


1011 


Branch on Minus. S - 1 










pppppp pppp 


PP 


pppp 






BZE 


DA 


7/9 


1000 


so 


0100 


Branch on ZEro. Z = l 




BEQ 


DA 




pppppp PPPP 


PP 


pppp 


Branch if EQual. Z-1 


.- 


BNZE 


DA 


7/9 


1000 


so 


1100 


Branch on No ZEro. Z * 




BNEQ 


DA 




pppppp pppp 


PP 


pppp 


Branch if Not EQual. Z - 




BLT 


DA 


7/9 


1000 


so 


0101 


Branch if Less Than. S-V^OV = 1 










ppwppp pppp 


PP 


PI^P 




. 


BGE 


DA 


7/9 


1000 

pppppp pppp 


so 
PP 


1101 

pppp 


Branch if Greater t*ian or Equal. S-V-OV =0 




BLE 


DA 


7/9 


lodd 
pppppp pppp 


so 
PP 


Olio 

pppp 


Branch if Less t han or Equal. Z V (S ^ OV) = 1 




BGT 


DA 


7/9 


1000 


so 


1110 


Branch if Greater Than. Z V (S-^OV) = 










pppppp pppp 


PP 


pppp 






BUSC 


DA 


7/9 


1000 


so 


0111 


Branch if Unequal Sign and Carry C'^S = 1 










pppppp PI^P 


PP 


pppp 




. 


BESC 


DA 


7/9 


1000 


so 


nil 


Branch if Equal Sign and Carry C-W-S « 










PPPPKK PPP? 


PP 


pppp 






BEXT 


DA,E 


7/9 


looo: 


SI 


EEEE 


Branch if EXtemal condition is True. Field E is externally decoded 
to select 1 of 16 conditions. Response is tested for true condition. 










pppppp PPI* 


PP 


pppp 
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APPENDIX B 
INSTRUCTION SET (continued) 



CONTROL 



MNEMONIC 


OPERAND 


CYCLES 


INSTRUCTION 


DESCRB>TION 


STATUS CHANGE 


GSWD 


DO 


6 


0000 110 ODD 


Get Status WorD in raster Eff). Bits 0-3, 8-11 set to 0. 
^s 4, 12 == C; 5. 13 = OV; 6, 14 = Z; 7, 15 = S. 




NOP 


<^ 


6 


0000 110 ION 


No operation. 




SIN 


<n> 


6 


0000 110 UN 


Software Biterrupt; pulse to PCIT * pin . 




RSWD 


SSB 


6 


0000 HI SSS 


Restore Status Word from r^^er SSS; Bit 4 to G. Bit 5 to OV, Bit 6 to 2^ 
Bit7t»S. 


S, Z, C, OV 


HLT 






0000 000 000 


HaLT after next instruction is executed. Resume on control start. 




EIS 






0000 000 010 


Enable Internet System. Not Int^nru^table. 




DIS 






0000 000 oil 


IHsable Interri4)t Systan. Not Interruptable. 




TCI 






0000 000 101 


Terminate Current Interrupt. Not Interruptable. 




CLRC 






0000 000 110 


CLeaR Carry to zero^ Not Intern9)table. 


C 


SETC 1 




0000 000 111 


SET Carry to one. Not Interri?)table. 


C 



JUMP 



JE 



JD 



JSR 



JSRE 



jSRD 



DA 



DA 



DA 



BB/DA 



BB, DA 



BB, DA 



12 



12 



12 



12 



12 



12 



0000 
llAA 
AAAA 



000 

AAA 

AAA 



100 
^00 
AAA 



0000 
llAA 
AAAA 



000 

AAA 

AAA 



0000 
IIAA 
AAAA 



000 

AAA 

AAA 



100 

AOl 
AAA 
100 
A 10 
AAA 



0000 
BBAA 
AAAA 



000 

AAA 

AAA 



100 
AOO 

AAA 



0000 
BBAA 

AAAA 



000 

AAA 

AAA 



0000 
BBAA 
AAAA 



000 

AAA 

AAA 



100 

AOl 

AAA 

100 

AlO 

AAA 



Jump to address. 



Program counter is set to 16 bits of a's. 



Jump to address. : Enable interrupt system. Program counter is set to 
Idbitsof A's. 



Jump to address. Disable interrupt system . Program counter is set 
to 16 bits of A*s. 



Jump and Save Return address (PC+3) in register designated by IBB. 
Program counter is set to 16 bits of A's. BB?^!! 



Jump and Save Return and Enable interrupt system. Return (PC+3) is 
saved in register IBB. Program counter is set to 16 bits of A's. BB^ll 



Jump and Save Return and Disable interrupt system. Return (PC+3) 

is saved in register IBB- Program counter is set to 16 bits of A's. BB^U 
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INSTRUCTION SET (continued) 
DIRECT AE«3RESSED DATA - MEMORY 

Field aaa aaa is dependent on the width of memory* 16 bits is maximum for aaaaaa AAAAAAAAAA. 



MNEMONIC 


OPERAND 


CYCLES 


INSTRUCTION 


DESCRIPTION 


STATUS CHANGE 


MVO 


SSS, A 


11 


1001 000 
aaaaaa AAAA AAA 


SSS 
AAA 


■■-"■"" ■ -" ' ■ ■ ■ ' 

MoV Out data from register SSS to address A - A. 




" MVI 


A, DDD 


10 


1010 000 
aaaaaa AAAA AAA 


DDD 
AAA 


Move In data from address A - A to register DDD. 




ADD 


A, DDD 


10 


1011 000 


DDD 


ADD data from address A - A to register DDD. Results to DDD. 


S, Z. C, OV 






10 


aaaaaa AAAA AAA 
1100 000 


AAA 
DDD 


SUBtract data from address A - A from' register DDD. Results to DDT). 


S, Z. C. OV 


SUB 


A, DDD 








aaaaaa AAAA AAA 


AAA 






CMP 


a; SSS 


10 


1101 000 


SSS ^ 


CoMPare data from address A - A with register SSS by subtraction. 


S. Z, C. OV 








aaaaaa AAAA AAA 


AAA 


Results not stored. 


.... , , 


AND 


A, DDD 


10 


1110 000 


DDD 


logical AND data from address A - A with register DDD- Results to DDD. 


S. z 




A, DDD 


10 


aaaaaa AAAA AAA 
nil 000 


AAA 
DDD 


exclusive OR data from address A - A with register DDD. Results to DDD. 


s, z 


XOR 




■ 




aaaaaa AAAA AAA 


AAA 







INDIRECT ADDRESSED DATA - REGISTER 



MMM Source data is located at the address contained in Register. 

MMM = 4, 5 post increment R4 or R5. 

MMM = 6 - MVO instruction - post increment R6. PUSH data from Register SSS to the Stack. 

Other instructions - pre -decrement R6. PULL data from the Stack to be used as the first operand. 



t— 



MVO@ 

PSHR 

MVI@ 

PULR 

ADD® 

siiB® " 



CMP® 




SSS, MMM 
SSS 

MMM, DDD 
DDD 

MMM, DDD 
MMM, DDd' 
MMMrODD 
MMMV DDD 
MMM , DDD 



9 

9 

8' 
11 

8' 
T' 

8 ' 

8' 

8' 



1001 


MMM 


SSS 1 


1001 


no 


SSS . 

4 


1010 


MMM 


DDD ] 


1010 


110 


DDD 1 


1011 


MMM 


DDD 


1100 


MMM 


DDD 

1 


1101 


MMM 


SSS 


nib 


MMM^ 


DDCT 


nil 


MMM 


DDD ' 



MoVe Out data from register SSS to the address in register MMM 

Note: SSS = MMM = 4, 5, 6 or 7 iwt siqiported. 

PuSH data from Register SSS to the stack. 

MoVe in data to register DDD from address in register MMM. 

PULl data from the stack to Register DDD. 

ADD data located at address in register MMM to the contents of register 

DDD. Results to DDD. _ _ _ ._ 

SUBtract data located at address in Register MMM from contents of 

register DDD. Results to PPP.^___^ __ _ _ ^ __ „ 

CoMPare data located at address in Register MMM with contents of 
register S^S^ by subtrac^cion^ R^uks not stored. 



logical AND contents of register DDD with data located at address in 
register MMM. Results to DDD. 



exclusive OR contents of register DDD with data located at address 
in register MMM. Results to DDD- 



jS, Z, C, OV 



S. Z, C. OV 



& z, c, pv 

S. Z 



s, z 



"Add 3 to number of cycles if MMM=6. 
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I*MBDIA*PE iJA'm -REGISTER 



APBBtmXB 
INSTRUCTION SET (continuecT) 

The niHiiber of iiiiii bits depends on the roeinory widt^/ 16 bits is laaxiroum* 



«ajEM(^n:c 


OPERAND 


CYGIiES 




INSTRUCTION 




DESCRIPTION 


TfSfOTTHSSaj 


MVOI 


SSS.I 


9 




1001 


111 


BBS 


Move Out Immediate data from register SSS to PC+1 










iiiiii 


XIII 


III 


III 


(field ) 




MVII 


I, DDD 


8 




1010 


111 


DDD 


Move In Immediate data to register DDD from PC+1 










iiiiii 


IIII 


ni 


I1I„ 

DDD 1 


(fi^ldl J. . _ 

ADD Immediate data to contents of register DDD. 




ADDI 


1 i^DDD 


8 




1011 


111 


B, Z, C, OV 




I, DDD 


8 


iiiiii 


nil 

1100 


in 

111 


in 

DDD 


Results to DDD. 

SUBtract Immediate data from contents of register 


S, Z. C. OV 


SUBI 


^ 






iiiiii 


nil 


in 


XII 


DDD. Results to DDD. 




CMPI 


I.SSS 


8 




1101 


111 


SSS 


CoMPare Immediate data from contents of register 


S, Z, C, OV 


^ 






iiiiii 


nil 


III 


III 


SSS by subtraction. Results not stored. 




ANDX 


I, DDD 


8 




mo 


111 


DDD 


logical AND Immediate data with contents of 


S, z 








Xlllll 


nil 


III 


III 


register DDD. Results to DDD. 




XORI 


I, DDD 


8 




nil 


111 


DDD 


exclusive OR Immediate data with contents of 


S, z 








iiiiii 


nil 


III 


in 


register DDD. Results to DDD. 





SDBD 




4 • 


0000 000 001 

rhis instruction is normally 
supplied by the ass^nbler as 
required to properly generate 
machine code. 


Set Double Byte Data for die next instruction which must be an 
external reference instruction. The effective address of the 
external r^erence instiniction will address the low order data 
byte; the address of the high order data byte will be EA4-1 if 
register 4, 5 or 7 is used. If register 1-3 is used the EA will 
access the same byte twice resulting in both bytes of data being 
the same. Use of modes and 6 are not supported by this instruction, 





INDIRECT ADDRESSED DOUBLE BYTE DATA - REGISTER 



SDBD 

MVI® 


MMM, DDD 


4 
10 


0000 000 001 
1010 MMM DDD 
000 000 001 
lOil MMM DDD 

omo (XX) 001 

upo MMM DDD 

oobo 000 oai 

1101 MMM SSS 
0000 000 001 
1110 MMM DDD 


MbVe In double byte data from the address in register MMM to 
register DDD. 




SDBD 
ADD® 


MMM, DDD 


4 
10 

4 
10 

10 

10 

4 

10 


ADD double byte data from the address in register MMM to the 
coi^nt of register DDD. Results to DDD. 


S. Z, C, OV 


SDBD 

SUB® 


MMM, DDD 


SUBtract double byte data located at address MMM from the 
content of register DDD. Results to DDD. 


S, Z, C, OV 


SE®D 
CMP® 


MMM, DDD 


CoMP^re (k)uble byte data located at address in register MMM 

with the content of register SSS by subtraction. Results is not stored. 


S, Z. C, OV 


SDBD 

AND® 


^ MMM, DDD 
MMM, DDD 


logical AND double byte data located at address in register MMM 
with die content of register DDD. Results to DDD. 


S, z 


SDBD 
XOR® 


0000 000 001 
HI MMM DDD 


exclusive OR double byte data located at address in register MMM 
with the content of register DDD. Results to DDD. 


S. z 
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APPENDIX B 



I N S T R U C T I O N SET (continued) 



IMMmiATE DOUBLE BY^TE DATA - REGISTER 



Note : The SDBD command is provided by the assemlder when the immediate data is greater than the 
memory width and requires two bytes. 



MVII 


1,DDD 


14 


0000 


000 


001 


MoVe In Immediate dguble byte data to register 










1010 


111 


DDD 


DDD. L's will be low byte and U's upper byte. 










XXLL 


LLL 


LLL 


XX = don't care. 










XXUU 


UUU 


UUU 




S, 2, C, OV 


ADDl 


t,DDD 


14 


0000 


000 


001 


ADD Immediate doiible byte data to contents of 








1011 


111 


DDD 


register DDD. Results to DDD. L»s indicate low 










XXLL 


LLI» 


LLL 


byte of literal^ U's upper byte. 










XXUU 


UUU 


UUU 




S, 2, C, OV 


SUBI 


I,DDt> 


14 


0000 


000 


001 


SUBtract Immediate double byte data from contents 








1100 


111 


DDD 


of register DDD. Results to DDD. L's indicate 










XXT.Ii 


LLL 


LLL 


low byte of literal, U*s upper byte. 










XXUU 


UUU 


UUU 






CMPI 


I.SSS 


14 


0000 


000 


001 


CoMPare Immediate double byte data with contents 


S, Z, C, OV 








1101 


111 


SSS 


of register SSS by subtraction. Results not 










XXLL 


LLti 


LLL 


stored. L*s indicate low byte of literal, U's 










XXUU 


UUU 


UUU 


upper byte. 


s, z 


AUDI 


I#DD0 


14 


0000 


000 


001 


logical AND Immediate double byte data with the 








1110 


111 


DDD 


contents of Register DDD* Results to register 










XXLL 


LLL 


LTJ, 


DDD. L's indicate low byte of literal, D's upper 










XXUU 


UUU 


UUU 


byte. 


s, z 


XORI 


1,DDD 


14 


0000 


000 


001 


exclusive OR Immediate double byte data with the 








lui 


111 


DDD 


contents of register DDD. Results to Register 










XXLL 


LLL 


LLL 


DDD. L's indicate low byte of literal, U's upper 










XXUU 


UUU 


UUU 


byte. 





GU>5SARY UF TERMS 



SS$ - Source Register 
DIJD " Destination Register 
n - Number of l^ifts 
RR - Register to Shift (only 0-a allowed) 
, AAAAAA Memory address for Jump* 

AAAAAAAAAA (new Program Counter) 

BB - Register to save old PC in for Jump. (Reg = IBB, 4, 5/ or 6) 
S " Sign of address displacement for Branch (PC relative), 
pppi^p PPPPPPPWP - Address displacement for Branch 

pppf^p is dependent on the memory word size, 
aaaaaa AAAAAAAAAA - Direct address of data word. 

aaaaaa is dependent on the memory word size, 
iiiiii lUmilH - Immediate data word, iiiiii is dependent on memory 
LLLLLLLL* Lowefr 8 bits of double byte data. word size. 
UUUUUUUU Upper 8 bits of double byte data. 



MMM " Address Mode 

direct address in location following instruction, 
indirect address for Register 1 
indirect ackiress for Register 2 
indirect address for Register 3 
indirect address for Register 4, post increment 
indirect address for Register 5, post increment 
indirect address for Register 6, post increment for MVO only 
indirect address for Register 6, pre decrement for all instruc- 
tions except MVO. 

indirect address for Register 7, post increment. 
(Immediate data in location following instruction.) 



000 
001 

oio 

Oil 
100 
101 
110 



111 
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APPENDIX C 

S16LNK OBJECT MODULE UNKER 
SAMPLE DIALOGUE 



S16LNK VER. OlA 

LOAD MODULE ? 
tlOCONVRT 

MAP ? lY/N OR F=NrAME) 
:y 

OBJECT MODULES 
: lOCNUROB 
: INASCOB 
tOUTASCOB 
:TTYINOB 
STTYOUTOB 
: 

GI S16LNK VEn. OlA 10:18 JAN 30* '75 
LOAD MODULE: I OCONVRT 

-I* 5|C 3fC 3f^ 

<BASE 000000> 
MODULE :CNVRT 
GLOBALS 

lOCNVR 000000 

<SIZE 000375> 
♦ ♦** 

<BASE 000375> 
MODULE: INASC 
GLOBALS 

HEXB IN 000375 

INTBIN 000401 

OCTBIN 000405 

BINS IN 000411 

<SIZE 000146> 
**** 

<BASE 000543> 
M0DULE:0UTASC 
GLOBALS 

HEXASC 000543 

INTASC 000547 

OCTASC 000555 

BINASC 000561 

<SIZE 000246> 

<BASE 00101 1> 
MODULE :TT YIN 
GLOBALS 
TTYIN 001011 
<SIZE 000223> 

<BASE 001S34> 
MODULE :TTYOUT 
GLOBALS 
TTYOUT 001234 
TYPCHR 001257 
TYPR2 001270 
<SIZE 000053> 



LINKAGE SUf^MARY: 

INITIAL ADDRESS 000000 

FINAL ADDRESS 001306 

ENTRY ADDllESS 000000 



APPENDIX D 
ASCII CHARACTER CODES 
Char 7 Bit Octal Code Char 7 Bit Octal Code 

Space 040 

! 041 

042 

# 043 
$ 044 
% 045 
& 046 

047 
( 050 

) 051 

* 052 
+ 053 

054 

055 

056 

/ 057 

060 

1 061 

2 062 

3 063 

4 064 

5 065 

6 066 

7 067 

8 070 

9 071 

072 

; 073 

074 

075 

076 

? 077 
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@ 


100 


A 


101 


B 


102 


C 


103 


D 


104 


E 


105 


F 


106 


G 


107 


H 


110 


I 


HI 


J 


112 


K 


113 


L 


114 


M 


115 


N 


116 





117 


P. 


'20 


Q 


121 


R 


122 


S 


123 


T 


124 


U 


125 


V 


126 


W 


127 


X 


130 


Y 


131 


Z 


132 


c 


133 


\ 


134 


: 


135 


t 


136 


«— 


137 



APPENDIX E 

GENERAL INSTRUMENT CORPORATION 
S16SIM-1 SIMULATOR COMMANDS 



RT SET REGISTER TRACE OR TRAP 

MT SET MEMORY TRACE OR TRAP 

RAM DEFINE RANDOM ACCESS MEMORY BLOCK 

ROM DEFINE READ ONLY MEMORY BLOCK 

lOSR DEFINE I/O DEVICE STATUS REGISTER 

lODR DEFINE I/O DEVICE DATA REGISTER 

INT DEFINE INTERRUPT 

EXT DEFINE EXTERNAL CONDITION 

LOAD LOAD PROGRAM 

E EXECUTE PROGRAM 

BDR EXECUTE AND DISPLAY REGISTERS 

S STEP PROGRAM 

C CONTINUE PROGRAM 

X EXIT SIMULATOR 

lA INITIALIZE ADDRESSES 

SA SEARCH ADDRESSES 

CPA CLEAR PREVIOUS ADDRESSES 

TLIM SET EXECUTION TIME LIMIT 

RADX SET DISPLAY RADIX 

SLIM SET STACK LIMITS 

MB MODIFY BRANCH INSTRUCTION 

MJ MODIFY JUMP INSTRUCTION 

DRT DISPLAY REGISTER TRAPS AND TRACES 

DMT DISPLAY MEMORY TRAPS AND TRACES 

DMB DISPLAY MEMORY BLOCKS 

DIOS DISPLAY I/O DEVICE STATUS REGISTERS 

DIOD DISPLAY I/O DEVICE DATA REGISTERS 

DINT DISPLAY INTERRUPTS 

DEXT DISPLAY EXTERNAL CONDITIONS 

R DISPLAY/MODIFY REGISTER 

A DISPLAY/MODIFY ADDRESS 

SR DISPLAY /MODI FY CPU STATUS REGISTER 

CLK DISPLAY/MODIFY CPU CLOCK RATE 

INFF DISPLAY/MODIFY INTRPT FF 

DR DISPLAY REGISTERS 

DA DISPLAY ADDRESSES 

DET . DISPLAY EXECUTION TIME 

DSYM DISPLAY SYMBOL VALUES 

DPA DISPLAY PREVIOUS ADDRESSES, IE, PC VALUES 

DMXS DISPLAY MAXIMUM STACK USED 



APPENDIX F 
OBJECT FILE FORMAT 

The object file produced by S16XAL contains relocatable object code generated during 
the assembly process. The file is composed of one or more 64 word records, each 
containing a three word header and up to 61 object data words. 

The first word in all records is equal to either 1 or 2 (-1 or -2 if the record is the 
last) which indicates a relocatable or absolute module respectively. The second word 
in the first record contains the assembly base address or origin, in subsequent records 
the second word has no significance. The third word in all records contains the number 
of object words following in the record. The remaining significant words in each record 
contain object code sequences derived from the assembly of instructions or directives. 

RELOCATABLE BINARY FILE 
RECORD FORMAT 



16 -bit 
word 



64 word 
record 



record header 

assembly base address 

number of data containing 
words in record 

data word 1 

data word 2 



data word n 



RELOCATABLE OBJECT CODE SEQUENCES 

The data information in each record of a S16XAL object file is grouped into sequences 
of variable length. The first word in each sequence contains a link/load code which 
indicates the number and nature of object words following in the sequence. 



Code 


No. Data Words 





1 


1 


1 


2 


2 


3 


3 


4 


1 


5 


2 


6 


3 


7 


2 


8 


3 


9 


1 


10 


2 


11 


2 


12 


3 


13 


2 


14 


3 


15 


1 


16 


2 


17 


2 


18 


2 



Object Word Significance 

address adjustment 

absolute word 

absolute word 

absolute word 

relocatable word 

absolute word, relocatable word 

absolute word, 2 relocatable 8 -bit bytes 

2 relocatable 8 -bit bytes 

absolute word, 2 relocatable 10 -bit bytes 

external reference word 

absolute word, external reference word 

absolute word, external reference displacement 

absolute word, 2 external reference 8 -bit bytes 

2 external reference 8 -bit bytes 

absolute word, 2 external reference 10 -bit bytes 

entry address word 

module uanae 

global symbol 

external symbol 



APPENDIX G 
BINARY PAPER TAPE FORMAT 

Binary paper tapes produced by S16BPT consist of variable length records which contain 
a four frame header and up to 132 data frames. The first significant frame in all 
records indicates a relocatable or absolute tape, 001 or 002 respectively (377 or 376 in 
the last record). The second and third frames in the first record contain the assembly 
base address or origin (low byte, high byte respectively); in subsequent records these 
two frames have no significance. The fourth frame contains the number of object data 
frames in the remainder of the record. The last data frame is followed by a record 
checksum frame which is used during loading to verify that the record has been read 
correctly. Object code sequences are the same as in a relocatable binary file except 
that the link/load code occupies one tape frame and each object data word occupies two 
tape frames, low byte, high byte respectively. The first record on a tape is preceded 
by approximately 50 frames of blank leader, the last record is followed by blank trailer 
of the same length and each record is separated by two blank frames. 



B 
L 
O 

C 
K 



BLANK LEADER 



HEADER 



Address (Low 8 bits^ 
Addre;^-(High-8.,bits) . , 

Fra me Count 

Link / Loa d Frame 
Low 8 bits, Word 1 



High 8 bits, Word 1 



Link / Lo ad Frame=0 



! Address Displ ace ment Low 8 bits 
j Address Displacement High. 8_ bits , 
\ Litik / Load Frame 



Low 8 bits. Word 2 



High 8 bits. Word 2 



HEADER CODES 

1 - Relocatable 

2 - Absolute 

1 - Last Block of Relocatable 

2 - Last Block of Absolute 



UNK/LOAD CODES 

Same as codes for OBJECT FILE 
FORMAT. 



^y 



CHECKSUM FRAME 



BLANK GAP 



BLANK GAP 



Header 



Blank Address 



Blank Address 



Frame Count 



L/L Frame 



Low 



High 



L/L Frame 
Low 




THE SERIES 1600 SOFTWARE LINE UP 
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FIRMWARE 
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